Autogenerated HTML docs for v2.2.0-rc0
diff --git a/git-daemon.html b/git-daemon.html index 337bce5..4548e24 100644 --- a/git-daemon.html +++ b/git-daemon.html
@@ -3,7 +3,7 @@ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> <head> <meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" /> -<meta name="generator" content="AsciiDoc 8.6.6" /> +<meta name="generator" content="AsciiDoc 8.6.9" /> <title>git-daemon(1)</title> <style type="text/css"> /* Shared CSS for AsciiDoc xhtml11 and html5 backends */ @@ -87,10 +87,16 @@ ul > li { color: #aaa; } ul > li > * { color: black; } -pre { +.monospaced, code, pre { + font-family: "Courier New", Courier, monospace; + font-size: inherit; + color: navy; padding: 0; margin: 0; } +pre { + white-space: pre-wrap; +} #author { color: #527bbd; @@ -219,7 +225,7 @@ } div.imageblock div.content { padding-left: 0; } -span.image img { border-style: none; } +span.image img { border-style: none; vertical-align: text-bottom; } a.image:visited { color: white; } dl { @@ -349,7 +355,7 @@ margin-bottom: 0.1em; } -div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 { +div.toclevel0, div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 { margin-top: 0; margin-bottom: 0; } @@ -407,18 +413,14 @@ span.overline { text-decoration: overline; } span.line-through { text-decoration: line-through; } +div.unbreakable { page-break-inside: avoid; } + /* * xhtml11 specific * * */ -tt { - font-family: monospace; - font-size: inherit; - color: navy; -} - div.tableblock { margin-top: 1.0em; margin-bottom: 1.5em; @@ -452,12 +454,6 @@ * * */ -.monospaced { - font-family: monospace; - font-size: inherit; - color: navy; -} - table.tableblock { margin-top: 1.0em; margin-bottom: 1.5em; @@ -537,6 +533,8 @@ @media print { body.manpage div#toc { display: none; } } + + </style> <script type="text/javascript"> /*<+'])'); + var re = new RegExp('[hH]([1-'+(toclevels+1)+'])'); // Function that scans the DOM tree for header elements (the DOM2 // nodeIterator API would be a better technique but not supported by all // browsers). @@ -610,7 +608,7 @@ var i; for (i = 0; i < toc.childNodes.length; i++) { var entry = toc.childNodes[i]; - if (entry.nodeName == 'div' + if (entry.nodeName.toLowerCase() == 'div' && entry.getAttribute("class") && entry.getAttribute("class").match(/^toclevel/)) tocEntriesToRemove.push(entry); @@ -656,7 +654,7 @@ var entriesToRemove = []; for (i = 0; i < noteholder.childNodes.length; i++) { var entry = noteholder.childNodes[i]; - if (entry.nodeName == 'div' && entry.getAttribute("class") == "footnote") + if (entry.nodeName.toLowerCase() == 'div' && entry.getAttribute("class") == "footnote") entriesToRemove.push(entry); } for (i = 0; i < entriesToRemove.length; i++) { @@ -778,12 +776,12 @@ for export this way (unless the <em>--export-all</em> parameter is specified). If you pass some directory paths as <em>git daemon</em> arguments, you can further restrict the offers to a whitelist comprising of those.</p></div> -<div class="paragraph"><p>By default, only <tt>upload-pack</tt> service is enabled, which serves +<div class="paragraph"><p>By default, only <code>upload-pack</code> service is enabled, which serves <em>git fetch-pack</em> and <em>git ls-remote</em> clients, which are invoked from <em>git fetch</em>, <em>git pull</em>, and <em>git clone</em>.</p></div> <div class="paragraph"><p>This is ideally suited for read-only updates, i.e., pulling from Git repositories.</p></div> -<div class="paragraph"><p>An <tt>upload-archive</tt> also exists to serve <em>git archive</em>.</p></div> +<div class="paragraph"><p>An <code>upload-archive</code> also exists to serve <em>git archive</em>.</p></div> </div> </div> <div class="sect1"> @@ -929,10 +927,10 @@ Allow ~user notation to be used in requests. When specified with no parameter, requests to git://host/~alice/foo is taken as a request to access - <em>foo</em> repository in the home directory of user <tt>alice</tt>. - If <tt>--user-path=path</tt> is specified, the same request is - taken as a request to access <tt>path/foo</tt> repository in - the home directory of user <tt>alice</tt>. + <em>foo</em> repository in the home directory of user <code>alice</code>. + If <code>--user-path=path</code> is specified, the same request is + taken as a request to access <code>path/foo</code> repository in + the home directory of user <code>alice</code>. </p> </dd> <dt class="hdlist1"> @@ -967,7 +965,7 @@ <dd> <p> Save the process id in <em>file</em>. Ignored when the daemon - is run under <tt>--inetd</tt>. + is run under <code>--inetd</code>. </p> </dd> <dt class="hdlist1"> @@ -979,20 +977,20 @@ <dd> <p> Change daemon’s uid and gid before entering the service loop. - When only <tt>--user</tt> is given without <tt>--group</tt>, the + When only <code>--user</code> is given without <code>--group</code>, the primary group ID for the user is used. The values of - the option are given to <tt>getpwnam(3)</tt> and <tt>getgrnam(3)</tt> + the option are given to <code>getpwnam(3)</code> and <code>getgrnam(3)</code> and numeric IDs are not supported. </p> -<div class="paragraph"><p>Giving these options is an error when used with <tt>--inetd</tt>; use +<div class="paragraph"><p>Giving these options is an error when used with <code>--inetd</code>; use the facility of inet daemon to achieve the same before spawning <em>git daemon</em> if needed.</p></div> <div class="paragraph"><p>Like many programs that switch user id, the daemon does not reset -environment variables such as <tt>$HOME</tt> when it runs git programs, -e.g. <tt>upload-pack</tt> and <tt>receive-pack</tt>. When using this option, you -may also want to set and export <tt>HOME</tt> to point at the home -directory of <tt><user></tt> before starting the daemon, and make sure any -Git configuration files in that directory are readable by <tt><user></tt>.</p></div> +environment variables such as <code>$HOME</code> when it runs git programs, +e.g. <code>upload-pack</code> and <code>receive-pack</code>. When using this option, you +may also want to set and export <code>HOME</code> to point at the home +directory of <code><user></code> before starting the daemon, and make sure any +Git configuration files in that directory are readable by <code><user></code>.</p></div> </dd> <dt class="hdlist1"> --enable=<service> @@ -1085,8 +1083,8 @@ <p> This serves <em>git fetch-pack</em> and <em>git ls-remote</em> clients. It is enabled by default, but a repository can - disable it by setting <tt>daemon.uploadpack</tt> configuration - item to <tt>false</tt>. + disable it by setting <code>daemon.uploadpack</code> configuration + item to <code>false</code>. </p> </dd> <dt class="hdlist1"> @@ -1096,7 +1094,7 @@ <p> This serves <em>git archive --remote</em>. It is disabled by default, but a repository can enable it by setting - <tt>daemon.uploadarch</tt> configuration item to <tt>true</tt>. + <code>daemon.uploadarch</code> configuration item to <code>true</code>. </p> </dd> <dt class="hdlist1"> @@ -1110,8 +1108,8 @@ can push anything into the repository, including removal of refs). This is solely meant for a closed LAN setting where everybody is friendly. This service can be - enabled by setting <tt>daemon.receivepack</tt> configuration item to - <tt>true</tt>. + enabled by setting <code>daemon.receivepack</code> configuration item to + <code>true</code>. </p> </dd> </dl></div> @@ -1127,8 +1125,8 @@ <dd> <div class="listingblock"> <div class="content"> -<pre><tt>$ grep 9418 /etc/services -git 9418/tcp # Git Version Control System</tt></pre> +<pre><code>$ grep 9418 /etc/services +git 9418/tcp # Git Version Control System</code></pre> </div></div> </dd> <dt class="hdlist1"> @@ -1143,9 +1141,9 @@ </p> <div class="listingblock"> <div class="content"> -<pre><tt> git stream tcp nowait nobody /usr/bin/git +<pre><code> git stream tcp nowait nobody /usr/bin/git git daemon --inetd --verbose --export-all - /pub/foo /pub/bar</tt></pre> + /pub/foo /pub/bar</code></pre> </div></div> </dd> <dt class="hdlist1"> @@ -1154,24 +1152,24 @@ <dd> <p> To set up <em>git daemon</em> as an inetd service that handles - repositories for different virtual hosts, <tt>www.example.com</tt> - and <tt>www.example.org</tt>, place an entry like the following into - <tt>/etc/inetd</tt> all on one line: + repositories for different virtual hosts, <code>www.example.com</code> + and <code>www.example.org</code>, place an entry like the following into + <code>/etc/inetd</code> all on one line: </p> <div class="listingblock"> <div class="content"> -<pre><tt> git stream tcp nowait nobody /usr/bin/git +<pre><code> git stream tcp nowait nobody /usr/bin/git git daemon --inetd --verbose --export-all --interpolated-path=/pub/%H%D /pub/www.example.org/software /pub/www.example.com/software - /software</tt></pre> + /software</code></pre> </div></div> -<div class="paragraph"><p>In this example, the root-level directory <tt>/pub</tt> will contain +<div class="paragraph"><p>In this example, the root-level directory <code>/pub</code> will contain a subdirectory for each virtual host name supported. Further, both hosts advertise repositories simply as -<tt>git://www.example.com/software/repo.git</tt>. For pre-1.4.0 -clients, a symlink from <tt>/software</tt> into the appropriate +<code>git://www.example.com/software/repo.git</code>. For pre-1.4.0 +clients, a symlink from <code>/software</code> into the appropriate default repository could be made as well.</p></div> </dd> <dt class="hdlist1"> @@ -1185,12 +1183,12 @@ </p> <div class="listingblock"> <div class="content"> -<pre><tt> git daemon --verbose --export-all +<pre><code> git daemon --verbose --export-all --interpolated-path=/pub/%IP/%D /pub/192.168.1.200/software - /pub/10.10.220.23/software</tt></pre> + /pub/10.10.220.23/software</code></pre> </div></div> -<div class="paragraph"><p>In this example, the root-level directory <tt>/pub</tt> will contain +<div class="paragraph"><p>In this example, the root-level directory <code>/pub</code> will contain a subdirectory for each virtual host IP address supported. Repositories can still be accessed by hostname though, assuming they correspond to these IP addresses.</p></div> @@ -1207,9 +1205,9 @@ </p> <div class="listingblock"> <div class="content"> -<pre><tt> [daemon] +<pre><code> [daemon] uploadpack = false - uploadarch = true</tt></pre> + uploadarch = true</code></pre> </div></div> </dd> </dl></div> 